From 508baa258c47dcf1283f9aaa89494c2522b2e41c Mon Sep 17 00:00:00 2001
From: Tim Janik <timj@gtk.org>
Date: Thu, 12 Jul 2007 16:13:36 +0000
Subject: [PATCH] clarified documentation example.

Thu Jul 12 18:03:02 2007  Tim Janik  <timj@gtk.org>

        * gdk/gdk.c (gdk_threads_add_idle_full): clarified documentation example.



svn path=/trunk/; revision=18458
---
 ChangeLog |  4 ++++
 gdk/gdk.c | 34 +++++++++++++++++++---------------
 2 files changed, 23 insertions(+), 15 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 4e68b5c3d7..fbebaa039e 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+Thu Jul 12 18:03:02 2007  Tim Janik  <timj@gtk.org>
+
+	* gdk/gdk.c (gdk_threads_add_idle_full): clarified documentation example.
+
 2007-07-12  Matthias Clasen  <mclasen@redhat.com>
 
 	* gtk/gtktextivew.c: 
diff --git a/gdk/gdk.c b/gdk/gdk.c
index 797187bc21..cf14ac4658 100644
--- a/gdk/gdk.c
+++ b/gdk/gdk.c
@@ -505,33 +505,37 @@ gdk_threads_dispatch_free (gpointer data)
  * in thread B:
  *
  * <informalexample><programlisting>
- * static gboolean idle_callback (gpointer data)
+ * static gboolean
+ * idle_callback (gpointer data)
  * {
+ *    // gdk_threads_enter(); would be needed for g_idle_add()
+ *
  *    SomeWidget *self = data;
- *     
  *    /<!-- -->* do stuff with self *<!-- -->/
- *     
+ *
  *    self->idle_id = 0;
- *    
+ *
+ *    // gdk_threads_leave(); would be needed for g_idle_add()
  *    return FALSE;
  * }
- *  
- * static void some_widget_do_stuff_later (SomeWidget *self)
+ *
+ * static void
+ * some_widget_do_stuff_later (SomeWidget *self)
  * {
- *    self->idle_id = g_idle_add (idle_callback, self)
+ *    self->idle_id = gdk_threads_add_idle (idle_callback, self)
+ *    // using g_idle_add() here would require thread protection in the callback
  * }
- *   
- * static void some_widget_finalize (GObject *object)
+ *
+ * static void
+ * some_widget_finalize (GObject *object)
  * {
- *    SomeWidget *self = SOME_WIDGET(object);
- *    
+ *    SomeWidget *self = SOME_WIDGET (object);
  *    if (self->idle_id)
  *      g_source_remove (self->idle_id);
- *    
  *    G_OBJECT_CLASS (parent_class)->finalize (object);
  * }
  * </programlisting></informalexample>
- * 
+ *
  * Return value: the ID (greater than 0) of the event source.
  *
  * Since: 2.12
@@ -552,8 +556,8 @@ gdk_threads_add_idle_full (gint           priority,
   dispatch->destroy = notify;
 
   return g_idle_add_full (priority,
-                          gdk_threads_dispatch, 
-                          dispatch, 
+                          gdk_threads_dispatch,
+                          dispatch,
                           gdk_threads_dispatch_free);
 }
 
-- 
2.30.2